# frozen_string_literal: true

# Copyright (c) 2017-2025 Tencent. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#    http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

require 'json'

module TencentCloud
  module Ims
    module V20201229
      class Client < TencentCloud::Common::AbstractClient

        def initialize(credential, region, profile = nil)
            api_version = '2020-12-29'
            api_endpoint = 'ims.tencentcloudapi.com'
            sdk_version = 'IMS_' + File.read(File.expand_path('../VERSION', __dir__)).strip
            super(credential, region, api_version, api_endpoint, sdk_version, profile)
        end


        # 本接口用于提交图片文件进行异步智能审核任务。使用前请您使用腾讯云主账号登录控制台 [开通图片内容安全服务](https://console.cloud.tencent.com/cms/image/package) 并调整好对应的业务配置。
        # ### 接口使用说明：
        # - 前往“[内容安全控制台-图片内容安全](https://console.cloud.tencent.com/cms/image/package)”开启使用图片内容安全服务，首次开通服务的用户可免费领用试用套餐包，包含**3000张图片**识别额度，有效期为15天。
        # - 该接口为收费接口，计费方式敬请参见 [腾讯云图片内容安全定价](https://cloud.tencent.com/product/ims/pricing)。

        # ### 接口功能说明：
        # - 支持对图片文件或链接进行检测，通过深度学习技术，识别可能令人反感、不安全或不适宜的违规图片内容；
        # - 支持对长图进行拆分检测；
        # - 支持识别多种违规场景，包括：低俗、违法违规、色情、广告等场景；
        # - 支持多种物体检测（实体、广告台标、二维码等）及图片中文本的OCR文本识别；
        # - 支持根据不同的业务场景配置自定义的审核策略；
        # - 支持用户自定义选择图片风险库，打击自定义识别类型的违规图片（目前仅支持黑名单配置）；
        # - 支持在审核图片内容时同时关联账号或设备信息，可识别违规风险账号或设备。
        # ### 接口调用说明：
        # - 图片文件大小限制：**Base64编码内容应小于10MB**；**图片资源应小于100MB**
        # - 图片尺寸支持：**长和宽 需>50分辨率且<40000分辨率，并且图片长宽比<90:1；**
        # - 图片文件分辨率支持：建议**分辨率大于256x256**，否则可能会影响识别效果；
        # - 图片文件支持格式：PNG、JPG、JPEG、BMP、GIF、WEBP格式；
        # - 图片文件链接支持的传输协议：HTTP、HTTPS；
        # - 若传入图片文件的访问链接，则需要注意**图片异步接口下载超时时间为15秒，失败后重试1次为3 秒，共18秒下载时间**，为保障被检测图片的稳定性和可靠性，建议您使用腾讯云COS存储或者CDN缓存等；
        # - 默认接口请求频率限制：**20次/秒**，超过此调用频率则会报错。
        # - ### 接口回调格式：
        # - 图片异步检测接口回调格式同[图片同步检测接口输出参数](https://cloud.tencent.com/document/product/1125/53273#3.-.E8.BE.93.E5.87.BA.E5.8F.82.E6.95.B0)

        # @param request: Request instance for CreateImageModerationAsyncTask.
        # @type request: :class:`Tencentcloud::ims::V20201229::CreateImageModerationAsyncTaskRequest`
        # @rtype: :class:`Tencentcloud::ims::V20201229::CreateImageModerationAsyncTaskResponse`
        def CreateImageModerationAsyncTask(request)
          body = send_request('CreateImageModerationAsyncTask', request.serialize)
          response = JSON.parse(body)
          if response['Response'].key?('Error') == false
            model = CreateImageModerationAsyncTaskResponse.new
            model.deserialize(response['Response'])
            model
          else
            code = response['Response']['Error']['Code']
            message = response['Response']['Error']['Message']
            reqid = response['Response']['RequestId']
            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
          end
        rescue TencentCloud::Common::TencentCloudSDKException => e
          raise e
        rescue StandardError => e
          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
        end

        # 本接口（Image Moderation, IM）用于提交图片文件进行同步智能审核任务。使用前请您使用腾讯云主账号登录控制台 [开通图片内容安全服务](https://console.cloud.tencent.com/cms) 并调整好对应的业务配置。
        # ### 接口使用说明：
        # - 前往“[内容安全控制台-图片内容安全](https://console.cloud.tencent.com/cms)”开启使用图片内容安全服务，首次开通服务的用户可免费领用试用套餐包，包含**3000张图片**识别额度，有效期为15天。
        # - 该接口为收费接口，计费方式敬请参见 [腾讯云图片内容安全定价](https://cloud.tencent.com/product/ims/pricing)。

        # ### 接口功能说明：
        # - 支持对图片文件或链接进行检测，通过深度学习技术，识别可能令人反感、不安全或不适宜的违规图片内容；
        # - 支持对GIF图/长图进行截帧或拆分检测；
        # - 支持识别多种违规场景，包括：低俗、违法违规、色情、广告等场景；
        # - 支持多种物体检测（实体、广告台标、二维码等）及图片中文本的OCR文本识别；
        # - 支持根据不同的业务场景配置自定义的审核策略；
        # - 支持用户自定义选择图片风险库，打击自定义识别类型的违规图片（目前仅支持黑名单配置）；
        # - 支持在审核图片内容时同时关联账号或设备信息，可识别违规风险账号或设备。

        # ### 接口调用说明：
        # - 文件大小限制：
        #     - 文件大小的最小限制为16字节；
        #     - Base64编码后的内容（仅限FileContent）应小于10MB；
        #     - 通过FileURL可访问的源图大小应小于30MB；
        # - 图片尺寸支持：长和宽需大于50像素且小于10000像素，并且图片长宽比需小于90:1；
        # - 分辨率建议：为保证识别效果，建议图片分辨率大于256x256。
        # - 文件格式支持：
        #     - **静态图**：BMP、ICO、JPEG、JNG、PNG、TIFF、RAW、SVG、GIF、WEBP、HEIC、AVIF
        #     - **动态图**：GIF、WEBP、HEIC（默认最多抽取5帧图像，每隔5帧进行一次采样）
        # - 传输协议：仅支持HTTP和HTTPS协议的图片链接；
        # - 并发请求与审核：每次仅能传输一条URL进行审核，支持多并发请求，默认并发量为100 QPS。超过此限制将返回`RequestLimitExceeded`错误；
        # - 存储与缓存建议：为了保障图片的稳定性和可靠性，推荐使用腾讯云COS存储或CDN缓存服务存放图片文件。

        # ### 图片下载说明：
        # 请根据以下规则调整您的图片链接和下载逻辑，以确保最佳的下载体验。
        # - 下载时间限制：图片的首次下载超时时间为3秒；如果首次下载超时，系统将自动重试一次，重试的超时时间同样是3秒；若重试后仍未能成功下载，系统将返回 `ImageDownloadError`（下载超时）；
        # - 网络安全策略：由于网络安全策略的影响，带有HTTP 302重定向状态码的链接可能会导致下载失败。请尽量避免使用此类链接，以确保下载过程顺利进行；对于因重定向或其他原因导致的下载失败，可能返回 `ResourceUnavailable.ImageDownloadError`；
        # - 异步回源支持：目前不支持通过异步回源方式获取图片源。请确保提供的链接为直接指向图片资源的链接，以避免因异步回源不支持而导致的下载失败。

        # <div class="rno-api-explorer" style="margin-bottom:20px">
        #     <div class="rno-api-explorer-inner">
        #         <div class="rno-api-explorer-hd">
        #             <div class="rno-api-explorer-title">
        #                 关于版本迭代的描述
        #             </div>
        #         </div>
        #         <div class="rno-api-explorer-body">
        #             <div class="rno-api-explorer-cont">
        #                 <p>当前页面版本为图片内容安全2020版本，2020.11.3日前接入的图片内容安全接口为2019版本</p>
        #                 <p>2020版本相对2019版本进行了升级，支持更灵活的多场景业务策略配置以及更丰富的识别回调信息，满足不同业务的识别需求，建议按照2020版本接入指引进行接口升级。</p>
        #             </div>
        #         </div>
        #     </div>
        # </div>

        # @param request: Request instance for ImageModeration.
        # @type request: :class:`Tencentcloud::ims::V20201229::ImageModerationRequest`
        # @rtype: :class:`Tencentcloud::ims::V20201229::ImageModerationResponse`
        def ImageModeration(request)
          body = send_request('ImageModeration', request.serialize)
          response = JSON.parse(body)
          if response['Response'].key?('Error') == false
            model = ImageModerationResponse.new
            model.deserialize(response['Response'])
            model
          else
            code = response['Response']['Error']['Code']
            message = response['Response']['Error']['Message']
            reqid = response['Response']['RequestId']
            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
          end
        rescue TencentCloud::Common::TencentCloudSDKException => e
          raise e
        rescue StandardError => e
          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
        end


      end
    end
  end
end